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1.0 PREFACE 



1.0 £££££££ 



1*1 unasiHOioN 



Tfce Object Code Utilities *re t collection of cojrn^nds wrier 

cen be used to ereete and update libraries* modify certain 
aspects of individual modules* and list various types of 
information for eacn module* 

TH« utilities accept as input object modules in CDC object 
text format ¥1*4 generated by cross compilers tod cross 
assemblers executing on CYBER 1.70* They run as stand-alone 
commands via the SES Processor. 



1.2 £££U£A£U.afl£Utt£!!!IS 



Trie following is a list of documents that either are referred 
to In this specification* or are rctco&niendet? to aid in 

understand I no and using these utilities. 



SES User's Handbook (60457250) 
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2*0 OBJECT CODE UTILITY COMMANDS 



2 . 0£l££I_£m2£_yiILIIX«£OMM££ 



The Object Cede Utilities use System Control Language CSCL) 
syntax as the parameter interface* In the descriptions that 
folio** opticus! parameters are enclosed in brackets* and ail 
parameters of type 'name'- can have a maximum length of 31 

characters* except for parameters designated as fill* mips 
tNGS file names cannot exceed 7 characters in length)* 

If the name of the generated file is the sw* as an input file 
nema* the n«^ file is generated on a scratch *ilt and then 
copied over the old file wren the generation is co&plete* 

In all of the commands* the input parameter keywords 
tfile I library and base ! btselib) art set up such that i # no 
keyword is specified or if the 'file 1 or 'base* keyword is 
specified* the input can be a collection of object modules 
formatted into a Library* or just a file containing one or 
more object Modules* If* however* the 'library* or •tsasel iM 
keyword is specified* the input push he formatted ss a 
Library* or a diagnostic is issued* The output is determined 
fey each particular command. 

Host of the parameters described do net have defaults* When a 
parameter does have a default* the default value is doeuirif nted 

in the parameter description. 

The ccpssands are described in alphabetical order* 
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2.0 OBJECT CODE UTILITY COMMANDS 

2.1 COn \ CHANGE OBJECT MODULE 



2.1 £<3£-JL£tiAi4££-i3fi4E£I-SafiUL£ 



This command allows the user to alter various char t ct er I st i cs 
of § module in the specified file* 

com 11 br §ry«<l oca l_f i le.nii?) 

modul e-<name> 

rnew.n0mt=<name>3 

CsubstituteM<<name>*<name>H#C<neme>»<nBme>)l*..)3 

[omit*(<n&me>£*<n8jfte>3«*«)3 

rgate*<<nsiBa>C*<nsj!?t >3... )3 

tnot.gate* (<name>t> <name>3« ♦ . ) 3 

fprocedure*<n«jne>3 

Cco»«ient*<str ing>3 

upon=<1ocai - .fif e^name> 

I ihrery ! life ! fi le ? f i 

This parameter specifies the neme of tbe ioc«l file 
containing the nodule to be changed. The specified 
file may or may not be t library, but if the keyword 
used is •lib' or 'library'* it must fee a library. 
Whether the 'uoon' file is » library is determined by 
the format of this input file. 

module \ mo J 

This perimeter specifies tbe neme of the module in the 
library to be chanoed. 

new.name » nn s 

Tbis parameter specifies 9 neme whieb replaces tbe 
name of tbe specified module. 

subst i tute ? s * 

This Parameter specifies entry point pairfs) whose 
nttres ere to be substituted. The pairs »re of the 
form {<ol<l entry point>#<new entry point>) where <oid 
entry point> is replaced by <ne« entry point>» 

cm i t * o * 

This parameter specifies entry pcint(s) whose 
definitions &r% to be removed from tbe output module. 

pate J g J 

This parameter specifies entry ooint(s) that ere to be 
gated in tbe output module. Gated entry points can fee 
entered from any ring within the files call bracket. 
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2.0 OBJECT CODE UTILITY COWHANDS 

2.1 COM « CHANGE OBJECT NODULE 



not^gate * ng * 

This parameter specifies entry poirt(s) for which the 

gated attribute is to be removed* 

procedure 1 pro s 

This parameter specifies the entry point at which 
execution is to begin (transfer symbol)* 

comment * co s 

This perimeter specifies the contents of the 
commentary field in the module header* 

upon * up t 

This parameter specifies the neme of the Iocs I file 

contiinino the new file. Whether the upon file is a 
library is determined by the format of the input file. 



Examples * 

SPS.CON LI8RARY=LIBX M0DUL£ = M00X Nf W_N AMF=tfHDY UP0N«LI82 

This command creates e nea library* *LIB2» which is 
id**nticsl to liferery 'LIS! 1 except that the neme of 
*wnoy* is changed to ■MODY 1 . 

SES.COH FILE1 *0DX S«( {£Pl#K j EWEPl) . ( E?2#NEWE PZ ) ) UP-FUE2 

This command creates t nev» file * FILE2 1 (may be 
library) identical to •FILfl 1 except that entry point 
neme •NEWEP1* replaces 'EPl 1 end 'NEWEPZ 1 repltces 
*€F2». 

SES.COM LI81 MQ*HODULEX G*ENT1 G«ENT2 NG*ENT3 PPC*ENT4 .. 
CC=«CPU MIGDS REVIEW UP*LI82 

This command creates a new library 'LI82* identical to 
•LIBl* except thft entry points in module MODULEX are 
modified as follows* ENT1 is removed* €HT2 is set to 
Cited; ENT3 is set to not gated; the transfer symbol is 
cheeped to ENT4J and the commentary field is chenoed.es 
shown* 
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2.0 OBJECT CODE UTILITY COMMANDS 

2.2 D60H | DELETE OBJECT MODULE 



2.2 £££*_! J2£L£I£-QaiLE£I-!ifi&UL£ 



This command allocs the user to delete a module or rsnst of 
modules from a specified file* 

dtciR I I brary*<l ocai«f H«.n«s»e> 

modul e*f <n«!ne>C . •<na«»€>3C#<n* nse>t • *<neme>3 3 • » * ) 
upon*<loeal_fi I t„niit> 

I ibrary t lib S file ! f i 

This pirapeter specifies the n#w$ of the loci! file 
containing the nioduie(s) or module sufer«neeCs) to be 
deleted. The specified file ir*^ y or fray not fee e 
library* but if the keyword used is 'lib* or 
•library 1 * it must be n library. Whether the 'upon 1 
file is a library is determined by tile fornsat of this 
input file. 

module * ?*o 5 

This pere^eter specifies the modulels) or module 
subrsngefs) to be deleted from the fils. If e 
specified module is not on the file* a fatal error is 
i ssued. 

upon * up s 

This otrameter specifies the naf>e of tbe local file 
upon wblcb tbe remaining modules ere written. Whether 
the upon Hie Is n library is determined by tbe format 
of tbe input file. 



Extffip! es s 

SFS.DEOH LI8RARY*LIB1 MODULE =f*OD X UP0N«LIB2 

This command creates a library LIB 2 identical tc LIB1 
except that nodule fiODX is deleted. 

SES. DEO^ FILE»FILEI *0« (HODA . . WGDB * MODC ) UP=FILE2 

This command creates a file FILE2 (will be library if 
FILF1 is library) identic*! to FILE! except that the 

modules between HGDA «nd HODS inclusive *nd HOOC are 

de I eted >• 



6C46033C C 



CDC - SOFTWARE ENGINEERING SERVICES 

ERS for SFS OBJECT CODE UTILITIES 



2-3 

1.3 DEC 8 3 
R E V * 1 



2.0 OBJECT CODE UTILITY COWHANDS 
?.3 OIOH ! DISPLAY OBJECT HODULE 



2 . 3 M£S_i_£im AX-flfii££I-fiQQUi£ 



This command allows the user to display Information about all 
or pert of the contents of a object file or library* The 
format of the list file produced is described In a later 

section of this document entitled "LISTING FILES". 

d ion* library«<locdi - .f1 f e_name> 

Lmodul eM<neme>C • • <name>'3 t.t<name>t • • <ne?!ie>3 1 . . • ) 1 

1 1 is ti ng*< I ocai.fi )e_nan>e>3 

fon-{<displ ay_opt ion>C»<display_option>l*««)3 

J ihrery S I ib S f i le i f t 

This parameter specifies the ni»e of the local fife 
«hcse contents are to he displayed. The specified 
file nay or may not he a library* hut if the keyword 
used is •lib 1 or • library f # it must he a library. 

module * mo : 

This parameter specifies the moduleCs) or nodule 
subrange(s) about uhich information is to he 
displayed. If t subrange is specified* ill modules in 

the subrange are displayed. Omission causes all 
modules in the file cr library to he displayed. 

J isting J list: 

This parameter specifies the local file name of the 
file en which the display information is to be 
written. Omission ceuses the information to he 
written to the job output file. 



on t 



of i nf or mat i on 



selected are 



This parameter specifies the level 

he displayed. Only the options 

effect. Valid specifications are: 

time and date module was created 
entry point definitions 'of the module 
module header information 
external references made by the module 
all information printed by 0> £* 
(default ) 



to 
in 



H and X 
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2*0 OSJgCT CODE UTILITY CDHPANDS 

2.3 DIOH 1 DISPLAY OBJECT MODULE 



Examples i 

SES.DIflM LIBRARY*LI81 HODULE-HODX LIST-IISTX PN-A 

This cowhand lists ill i nfonnst ion about 'module 
I ibf ary LI81 on file LISTX. 



HODX of 



SES.OIOH FIL£=FIL£X HQ= CHOOA. .^ODB^HCDC ) ON»ID#H>X) 

This command lists date and tin?* created* wcdule header 
information* and external references about iroduies HODA 
to HG08 inclusive and MODC of FILEX lw*y fee library) on 
f i U OUTPUT {default). 
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2*0 "OBJECT CODE UTILITY COMMANDS 

2*4 GIF I GENERATE Q8JECT FILE 



2.4 £C£_i_££i*££AI£-£W££I-£IL£ 



This command allows a user to generate or update an object 
file* Also* several object files or libraries can be combined 
into one object file. Perimeters for this eonifitnd are 
described under 'GPL - Generate Object Lifersry' ^hich follows 
be I ow. 



2*5 £SL-i-fi£ti££AI£-I3ai£CI-LIfifiA£I 



This comund siloes a user to generate 
library* Also* several object files 
combined into one object library* 



or update a object 
or libraries can be 



Description for calling either 
to I Ic^s be I owl 



the * GOF* or * G-OL * commands 



oof ! gol 

rfile-{<loc3i_file_name>£*<lcc8l_file_.ns!re>i. # ,n 

fcom fc ine- (<na?*?e>C ■• .<neme>ir. •<n«iB«>{ • . <newe>3 1* • * 3 3 

C«dd*{<naiBe>C« .<neme>3£»<n»me>t « •<nair>e>13«*. ) 3 

Creplace*(<naRt8>£«»<rian!e>3£*><na!ne>)««<n0R!e>3!U««)3 

f a ft er*<namt>3 

tbase*(<i oca l_f i le - .name>C#<locsl_^i i £_n£me>3 * ♦ ♦ ) 3 

upon*< I ocal.fi le_name> 

f I 1st Inq-<1 oca l_f I le_name>3 

file \ f ! librery 1Mb: 

This parameter specifies the nsimes o f the files from 
which object modules specified by the following three 
perimeters ere to be obtained for the ne* file. The 
specified file(s) may or may not be lifcrery(s)» but if 
the keyword used is 'lib 1 or 'library 1 * they roust be 
I i br er y Is) • 



The next three parameters <»ccmbi 
'replace*) specify module ts) or modu 
be Included on the new file from the 
by the ■file/library* parameter. 
all three parameters may be specified 
specified* ell the modules on the f 
the 'file /library 1 parameter will be 
new file* Only the first occur r 
modules are included in the new file 
below* the particular paremeterCs) u 



ne'i 
I e su 
f i le 

None.* 
I 
i les 

i n c I u 

ence 
A 

sed o 



■add 1 

tr anoe 

s spe 

one • 
f non 
sped f 
ded o 
of dup 
s exp 
i ve th 



» a n d 
(s) to 
c i f i e d 
two or 
e ere 
i ed by 
n the 
I i c « t e 
I a i n e d 
e user 



6CAfcC330 01 



5 — ft 

CDC - SOFTWARE ENGINEERING SERVICES 

13 DEC 63 
IRS for SfS 08J£CT COOg UTILITIES REV? 1 

2,0 OBJECT CODE UTILITY COMMANDS 
2.5 C-OL ! GENERATE OBJECT LIBRARY 



control over whether the given modules should exist on 
the •base* llbrary(s). 

combine l co s 

This parameter specifies modulefs) to be included in 
the new file* The specified module (s) may or ny not 
exist on the •base* fileCs). If they exist.* they are 
rep I seed. 

add s 

This parameter specifies moduleCsl to be added on the 

new file.. If a specified module duplicttes a module 
already on a file specified by the •best 1 parameter* a 
fetal error is issued* 

replace i rep * 

This partmeter specifies mcdulels) to be replaced on 

the new file. If a specified module does not already 
exist in a fife specified by the f bese' parameter* a 
fete I error is issued. 

ifter * «f * before * be i 

This perimeter specifies e module on * buse file sifter 
or before which to position the new modules. Default 
position is after the last module on the last base 
1 1 b r a r y • 

base J b * fees e lib * bl : 

This parameter specifies e list of files to he 
included in the new file. All modules from the base 
files become oert of the new file except duplicate 
modules (the first occurrence of the module takes 
precedence). The specified file(s) may or way not be 
library(s)* but if the Keyword used is 'bl' or 
'baselib 1 * they must be librery(s). 

uoon \ up » 

This parameter specifies the local file name of the 
new Hie* If the filename specified duplicates en 
existing local file.* the file is oenereted and then 
copied to the specified file* 

Msti no \ list J 

This parameter specifies the ntme of the listing file 

on which the names of the modules on the new file ere 
listed in the order in which they occur* bs well as 
the file from which they came. If this pt remeter is 
not specified* no "listing" output is produced. The 
formet of this file Is described in a later section of 

6C46C330 CI 
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2.0 OBJECT CODE UTILITY COMMANDS 

2.5 GQL I GENERATE OBJECT LIBRARY 



this document entitled "LISTING FILFS M . 



The utiiity requires that there he an input' flit specified 

either by the f fHt f Piratft«r# or •base* parameter* By 
utilising the 'add'* •replace 1 * and 'module* parameters* the 
user can control exactly *hich modules from the #i!e<s) 
specified by the •file' parameter he wants to include on the 
new file* wM ie the 'after* and *before f parameters a 1 I ow htm 
to position the new modules* The keyword specified for the 
•upon 1 parameter controls whether the resulting nt« file is t 
library. For § more detailed listing of the nodules on the 
library? the user can use the DlOH command* 



Ex amp I **s : 

SES.CQL FIt£*FILEX LIST*LISTX ULON«NEW 

This command creates an object library NE^LIB *bicb 
contains til the modules from file FILEX (may he 
library)* Display i nf ormat ion appears on the file 
LISTX. 

SES.GOL LIB«IN?LI8 A00-HGD1 REP«M0C2 Bl«BASELI8 UP-NEWIIB 

This command creates en object library NEyLIB identical 
to library BASELXB except that module M(?D2 from library 
INPLIB replaces H0P2 end module W0D1 from INPLIB is 

&$6b$ at the nn$, 

SI:S.GOF BASE»(FILFl*FIt?2f FILE31 UPON*NFV/FILF LI STING*LI5T X 
This command creates an object file Inot library* 
NEWFILE which is the combination of files FILE1* FILE2 
and FILE3. Only the first occurrance of duplicate 
modules uppears on the new file* Display information 
appears on file LISTX. 

SES.GHP FILEA,FILEB HO* (NODA. . H0D8 , HODC ) AFTER*MPDX .. 
BASF*8ASFFILE U?*NFWFILE 

This command creates an object file NEWFILE usino file 
BASEFILE as a base. tfcdules POD A thru MODB inclusive 
and HOOC from files FILEA and FILE8 (may be libraries) 
ere b<$6.*6 after module HOOX. 
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3.0 M£5SA£££ 



The following passages in output ft the termination of 
commands. AH errors cause command to abort* 



13001 FILE filename NOT LOCAL 
SEVERITY? Error 
WEANING i Self «xpan«tory. 

130C2 HISSING IDENTIFICATION RECORD IN FILE * il e.„ne^e 
SEVERITY! Error 

MEANING! Date it the beginning of a mo'duie does 
not match expected fcrmtt. 

13003 UNEXPECTED IDENTIFICATION RECORD IN FILE file. name 

SEVERITY: Error 

MEANING! Second identification record found 
before end of module. 

13004 UNKNOWN OBJECT TcXT INFILE file.naire 

SEVERITY? Error 

MEANING: Self explanatory. 

13005 FILE file_na*e IS NOT LIBRARY 

SEVERITY! Error 

MEANING* Source or base file declared as 
I i brar y is net one • 

13010 MODULE module.neme NHT FOUND 

SEVERITY: Error 

MEANING* Self explanatory. 

13011 DUPLICATE MODULE irodul e_n»m« DECLARED 

SEVERITY* Error 

MEANING! Module specified more than once. 

13012 END OF MODULE RANGE wodui e.nsirel .. *odu I e_nanje2 

NOT FOUND 

SEVERITY! Error 

MEANING! Self explanatory. 

131CC GENERATION OF type filename COMPLETE 
SEVERITY! Inform* tionel 

6C46C330 CI 
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HEADING? Generate cowhand normal termination 
(type specifies if library)* 

131C1 MODULE module.name LOCATION TO AOO NOT FOUND 

SEVERITY* Error 

MEANING* Module declared as position for new 
modules (before or after) not found on 
bftse'file(s) for generate command* 

13102 MODULE moduie.name TO ADD ALREADY EXISTS ON BASF 

*l I e^name 

SEVERITY: Error 

WEANING* Nen module specified by •ADO 1 

parameter of generate command is 
already present on a b?se library. 

13103 MODULE modu I s.ni^e TO M. REPLACED NOT FOUND 

SEVERITY* Error 

MEANING* New moduli specified by 'REPLACE 1 

parameter of generate command dots dot 

exist on any of the base file(s)* 



13105 FILE filename HAS THE SAME NAME AS A SOURCE FILE 
SEVERITY: Error 

MEANING* A base file has the same name as a 
source file. 

13?CC MODULES DELETED ON FILE fiie.name 
SEVERITY: Informational 
MEANING* Delete command normal terminate* 

132C1 ALL MODULES DELETED ON FILE *He_name 
SEVERITY: Warning 
MEANING* 'UPON* file of this delete command 

contains no modules because tbey were 
ail del eted* 

133C0 MODULES CHANGED ON FILE file.name 
SEVERITY: Inf oriit i onal 
MEANING Change command normel terminate 
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13301 ENTRY POIMT ent ry.po i nt.n ame TO CHANGE HOT FOUND 
SEVERITY! Error 
MEANING* Entry point to substitute* oirlt* gate* 

or not_ittt« usinf cbunpe command not 
found* This mtsstga cm also indicate 
that no #ntry point Mas found to stitch 
the new tranter symbol (PR0C£DURF 
parameter)* 

134CC HODULES FROM FILE file.naae DISPLAYED 
SEVERITY! Informational 

NEANINGJ Display zommvntl norctii terminate* 
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4.0 LISTING FILES 
4.0 USII!i£-£Il£S. 



The generate and display commands 
f cl I cm I n g formats* 



per crate listings of the 



4*1 £££Z£QiJLISIia£-£££aAI 



The Generate Object File Library coinvands produces an 
output fife C , LIST f parameter) to show the disposition of 
icdults from the source and base files in the order they are 
encountered. The format of the listing is as follows* 



GENERATE.08JECT.fi It/I ibrary 
MODULE NAHE FILE NAME 



PAGE xx 



modu le.ntnie.l 
niodu le._na»e_2 
modu I e.name.3 
rnodu I t - nflfl»e - ,4 



f i I e.nsme 
f i ie.nawe 
base. name 
bass.newe 



STATUS 

ADDED 
SEPIACED 

DELETED 



In the Hstinot 'file/library 1 indicates whether a library 

was generated. The module.names shew the modules on the new 
library (except if STATUS*DELETED3 . Fi t e.napes Indicated the 
source or base file the irsodule cafe ?rom. Status indicates 
the following! 



-blank- module copied fro* 
ADDED module added from 
REPLACE module fro?*? source 

base I ibrary 
DELETED module frow s base 



base I ibrary 
source file 
file repleced 



one 



I i tor er y was de I eted 



duplicated one from * prevoius base 



froff a 

s i nee i t 
I i brer y. 
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4.0 LISTING FILES 

4.2 OIOW LISTING FORMAT 



4*2 MSB-LISII££.EQllfiAI 



The Display Object Module cc»if*n<J produces *n output files 
(LIST parameter! to shon the reouested information about the 
specified nodules* The format of top rrintout requesting all 

information (parameter 0N=A) is shown helow* 



DISPLAY OF 0BJECT_f i f /lib - filename dat/tim 



PAGE xx 



*PDULF* irod.name CREATED* date/tlae KIND* rcod.kind 

GENERATOR NAME VERS: gfin.nsnie 
Cr^MENTARY* context 



ENTRY POINT DEFINITIONS 

M M M W M W W M «• W M 



)Wtt*M**l 



ep_o iif?e 



(2 Ptr I i ne I 



EXTERNAL REFERENCES 

ext niif 



<2 per line) 



In the printout* f i i / 1 i b Indicates whether the file is a 

Horary. The filename and dtte/tiise of the display appear in 
the page header* For each module* 



naie of module being OISPLAYed 

date end time created 

module kind <HVS# VVS* I0U# HC68O0O* or P.CCOE) 

generator name and version 

corcwentary text from identification record 

name of entry point? If this entry point is 

gated* "GATED" precedes the nan; Multiple 

entry points are allowed* 
name of external f Multiple externals are 

at I o w ^ d • 



pod. 


_narre 


dat 


e/t i ase 


w cd, 


.Kind 


fen. 


.nfi^s 


CCIB, 


.text 


*P- 


niii 



ext.nsif 
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